home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / digfos12.zip / DF.DOC next >
Text File  |  1993-01-20  |  13KB  |  331 lines
  1.  
  2.                            DIGIFOSSIL V1.2 - Jan 20, 1992
  3.  
  4.                             FOSSIL Driver for DigiBoards
  5.                           ================================
  6.  
  7.                                                Technique Computer Systems
  8.                                                Ste 110, 1841 Oak Bay Ave
  9.                                                Victoria, BC   V8R 1C4
  10.                                                CANADA
  11.                                                BBS: (604) 598-1546
  12.                                                FAX: (604) 598-4318
  13.  
  14.  
  15.           What is it?
  16.           -----------
  17.           DIGIFOSSIL (DF) is  the program YOU  need in order  to get a huge
  18.           number of  doors, written for  FOSSIL systems,  working with your
  19.           Wildcat! IM system.  (if you need a FOSSIL for a non-IM/Digiboard
  20.           system,  try either  X00 or  BNU, which  are available  from many
  21.           BBSs)
  22.  
  23.  
  24.           What is a FOSSIL anyway?
  25.           ------------------------
  26.           FOSSIL  (Fido/Opus/Seadog  Standard Interface  layer) was created
  27.           to  provide  a  standard   communications  interface  during  the
  28.           evolution of some other BBS  software (namely Fido(tm),  Opus and
  29.           Seadog(tm)).  It  provided a  superset of  the serial  port calls
  30.           available  on  the early  IBM  PC,  and provided  a  way  to port
  31.           programs  from  one  system  to  another,  that  may  not contain
  32.           hardware compatible serial ports, to the IBM PC.
  33.  
  34.           By writing programs that use a standard set of calls, all that is
  35.           required  to move  the system  to dissimilar  hardware, is  a new
  36.           FOSSIL driver.
  37.  
  38.  
  39.           What does DIGIFOSSIL do?
  40.           ------------------------
  41.           It provides the translation services so that calls made to FOSSIL
  42.           standards are  translated into equivalent  Digiboard calls.  This
  43.           allows HUNDREDS of  applications written for  FOSSIL to run under
  44.           IM, as if they were running  on a FOSSIL based system.  This list
  45.           includes many  popular doors such  as Tradewars  & Scrabble (tm).
  46.           Think  of  it as  the  'missing  link' between  your  Wildcat! IM
  47.           system, and vast number of existing doors.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                         - 1 -
  59.  
  60.             DigiFossil (c) Copyright 1992,1993 Technique Computer Systems
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           Installation
  69.           ------------
  70.           Simple,  part of  your AUTOEXEC.BAT,  before Desqview  is loaded,
  71.           should load the TSR driver for DF.  Simply add:
  72.  
  73.                        DFTSR
  74.  
  75.           to  your  AUTOEXEC.BAT.   When  DFTSR  starts,  it  will identify
  76.           itself,  and indicate  the  type of  Digiboard  installed.  DFTSR
  77.           currently  takes about  14k  of memory,  and  can be  loaded into
  78.           'HIGHRAM' using QEMM's LOADHI, or DOS 5's LOADHIGH commands.
  79.           It must be loaded AFTER the DigiBoard (XIDOS5) driver is loaded.
  80.           DFTSR does  not enable  FOSSIL support,  that is  done separately
  81.           with DF.
  82.  
  83.  
  84.           Using Doors that work with FOSSIL Drivers
  85.           -----------------------------------------
  86.           Although  DIGIFOSSIL may  not run  all doors,  it will  run those
  87.           doors that  require or  support FOSSILs.   If a  program does not
  88.           mention that  it will utilize  a FOSSIL, it  probably doesn't use
  89.           it, and won't work with DIGIFOSSIL.
  90.  
  91.           When  running  a door  that  uses  FOSSIL calls,  simply  use the
  92.           program DF to enable or  disable FOSSIL support in the DIGIFOSSIL
  93.           driver (DFTSR which was loaded in your AUTOEXEC.BAT).  To run DF,
  94.           simply specify which Digiboard channel,  and whether to enable or
  95.           disable support.   If no  port number is  given, DF  will use the
  96.           port specified by the environment variable WCPORTID.
  97.  
  98.           ** NOTE **
  99.           **    Be sure that if you enable FOSSIL support, that you
  100.           **    disable it again before re-loading Wildcat!.
  101.           **    (I suggest that you add DF OFF to your CAT.BAT)
  102.           ** NOTE **
  103.  
  104.           examples:   DF ON 1     - turn on FOSSIL support for port 1
  105.                       DF OFF      - turn off support for port WCPORTID
  106.                       DF LOCK 1   - turn on FOSSIL support for port 1
  107.                                      but don't allow the door to change
  108.                                      the baud rate.
  109.  
  110.           When  using doors  that support  FOSSIL,  such as  Scrabble, COM1
  111.           (w/FOSSIL),  is  the  same as  Wildcat's  port  1  (and Digiboard
  112.           channel  0).  That  is to  say, if  you set  WCPORTID to  1, your
  113.           should tell the DOOR to use (FOSSIL) COM1.
  114.  
  115.           If you have a door that does  NOT support a locked DTE rate (that
  116.           is when the baud rate to the modem is higher than the actual link
  117.           connection speed), AND  you are using  a modem that  has a locked
  118.           DTE, you should can use the DF LOCK command rather than the DF ON
  119.           command, which will prevent the  DOOR from changing the baud rate
  120.           on the modem.
  121.  
  122.  
  123.  
  124.                                         - 2 -
  125.  
  126.             DigiFossil (c) Copyright 1992,1993 Technique Computer Systems
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.           ** NOTE! **
  135.               Programmers  writing code  that makes  FOSSIL calls
  136.               should  note  COM1, and  WCPORTID=1  both  refer to
  137.               channel 0 (DX=0) in the  actual with respect to the
  138.               actual FOSSIL and DigiBoard drivers.
  139.  
  140.           Examples
  141.           --------
  142.           This is an  example DOOR.BAT for  Chris Hall's excellent Scrabble
  143.           door.
  144.  
  145.           DOOR1.BAT
  146.              @ECHO OFF
  147.              REM This batch file is located in your HOME directory,
  148.              REM and is copied to the work directory and executed.
  149.              REM It needs to change to the right location of the
  150.              REM door and run the program
  151.              REM
  152.              REM  ******* Enable Fossil
  153.              DF ON
  154.              CD \DOORS\scrab
  155.              scrabdor node%WCNODEID%.cfg
  156.              CD \WC30
  157.              REM  ******* Remember to turn it off again
  158.              DF OFF
  159.  
  160.  
  161.           Files
  162.           -----
  163.           The following files should be included in this archive, and for
  164.           authenticity,   it   should   contain   the   PKZIP  authenticity
  165.           verification for TECHNIQUE COMPUTER SYSTEMS.
  166.  
  167.               DF.EXE         - to enable and disable DIGIFOSSIL support
  168.               DFTSR.EXE      - the DIGIFOSSIL driver
  169.               DF.DOC         - this document file
  170.               ORDERFRM.DOC   - Ordering information
  171.  
  172.  
  173.           Registration & Ordering
  174.           -----------------------
  175.           DIGIFOSSIL is  NOT free.  Although  it is distributed  in a fully
  176.           functional   form,  continued   use   beyond  30   days  requires
  177.           registration.   Registered  versions   are  always  available  to
  178.           registered users on the PLYWOOD PC BBS at 604-598-1546.
  179.           Registration costs $15 (US), or $18 (Canadian).  To order, please
  180.           use the order form found in this archive.  You can also order the
  181.           product  online on  the Plywood  PC BBS  at 604-598-1546,  or FAX
  182.           completed order  forms to  604-598-4318.  With  your registration
  183.           you will receive:
  184.  
  185.               - a disk with the registered version of DIGIFOSSIL
  186.               - a certificate of registration
  187.  
  188.  
  189.  
  190.                                         - 3 -
  191.  
  192.             DigiFossil (c) Copyright 1992,1993 Technique Computer Systems
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.           Support
  201.           -------
  202.           For further information, or technical support of DIGIFOSSIL, your
  203.           best bet is to call the call the Plywood PC BBS at 604-598-1546
  204.           (V32bis/HST), and join conference 2 (DIGIFOSSIL support).
  205.           Other options are: leave email to SCOTT BRYNEN in the 3rd party
  206.           support conference on MSI's Bulletin Board (805-395-0650), or the
  207.           MSI-OffTopic conference, that is echoed to many email networks.
  208.           Another option is to FAX us at 604-598-4318.
  209.  
  210.           Some FOSSIL applications may not work.  If you have problems with
  211.           a specific application  (or have found one  that works well), let
  212.           us know, so  that in future  versions we can  list doors that are
  213.           known to work.
  214.  
  215.           If  you  have  a  node  that  crashes  during  operation  of  the
  216.           DIGIFOSSIL, please make  a note of the  conditions under which it
  217.           happened,  and  if  you  are able,  open  another  DOS  window in
  218.           Desqview, and type
  219.                 DF STAT <port-number>
  220.           where  <port-number>   is  the   port  that   has  failed.   This
  221.           information that this provides will  be most helpful in trying to
  222.           diagnose what has happened.
  223.  
  224.  
  225.           Updates
  226.           -------
  227.           By  registering the  product  with Technique  Computer,  you will
  228.           receive the most recent version by mail (please allow 6-8 weeks),
  229.           and be able  to download the  latest version of  it from our BBS.
  230.           Once  you are  registered, you  can  download future  versions of
  231.           DIGIFOSSIL from the Plywood PC BBS.
  232.  
  233.  
  234.           Credits
  235.           -------
  236.           I have a few people to thank.  Firstly, I would like to thank Ron
  237.           Green, and Ken O'Connor for their patience, and for letting me at
  238.           their Wildcat!  IM baby in  order to get  DIGIFOSSIL working, and
  239.           also to Ron Green for saying "but we can't run Scrabble now we've
  240.           gone to Wildcat! IM",  and to Chip North (and his co-sysop), for
  241.           actually  proving that it works with more than Scrabble.  Also to
  242.           the some other sysops, notably  David Spellman and Charles Alpert
  243.           that have helped in tracking down some of the odder problems.
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.                                         - 4 -
  257.  
  258.             DigiFossil (c) Copyright 1992,1993 Technique Computer Systems
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.           History
  267.           -------
  268.           Version 1.2 - Jan 20/1993
  269.                    - various internal optimizations
  270.                    - fixed some problems with software detecting
  271.                       DF being installed
  272.                    - DFTSR now loads on system where the first channel
  273.                       isn't channel 0
  274.  
  275.           Version 1.1 - Jan 11/1993
  276.                    - Added support for forcing Locked DTEs.
  277.                    - Added beg screen to unregistered version.
  278.                       (lack of registrations caused this)
  279.                    - Fixed typos in the orderform.
  280.                    - Added better support for detecting errors during
  281.                       installation.
  282.  
  283.           Version 1.0 - Dec 25/1992
  284.                    - Initial Release
  285.  
  286.  
  287.           Legal Stuff
  288.           -----------
  289.           DIGIFOSSIL  is Copyright  1992-1993, Technique  Computer Systems,
  290.           all rights  reserved.  This  product is  provided "AS-IS" without
  291.           warranty of any kind.  All risk as to the results and performance
  292.           are  assumed  by you.   Technique  Computer Systems  will  not be
  293.           liable for  any damages, direct  or indirect,  resulting from the
  294.           use, or inability to use, this product.
  295.  
  296.           Wildcat! isn't actually a trademark of Mustang Software Inc (but
  297.                         is a very good BBS package)
  298.           DigiBoard could be a trade mark of Digi
  299.           Fossil (Fido(tm)/Opus/Seadog(tm) interface layer), is the
  300.                         combined product and ideas of Tom Jennings, Thom
  301.                         Henderson, Vince Perriello, & Wynn Wagner (& many
  302.                         more).
  303.           Fido is a trade mark of Tom Jennings
  304.           Seadog is a trade mark of Thom Henderson and/or System
  305.                         Enhancements Associates.
  306.           QEMM and Desqview are trade marks of Quarterdeck Office Systems.
  307.           Scrabble is a trade mark of Hasbro Inc.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.                                         - 5 -
  323.  
  324.             DigiFossil (c) Copyright 1992,1993 Technique Computer Systems
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.